Skip to content

[skip changelog] Document packages[*].platforms[*].deprecated package index field #1510

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Oct 14, 2021
Merged

[skip changelog] Document packages[*].platforms[*].deprecated package index field #1510

merged 1 commit into from
Oct 14, 2021

Conversation

per1234
Copy link
Contributor

@per1234 per1234 commented Oct 14, 2021

Please check if the PR fulfills these requirements

  • The PR has no duplicates (please search among the Pull Requests
    before creating one)
  • The PR follows
    our contributing guidelines
  • Tests for the changes have been added (for bug fixes / features)
  • Docs have been added / updated (for bug fixes / features)
  • UPGRADING.md has been updated with a migration guide (for breaking changes)
  • What kind of change does this PR introduce?

Docs update

  • What is the current behavior?

In the event an Arduino boards platform is deprecated by the maintainer, it will be useful to clearly communicate this
fact to the user and ensure they will easily find a preferred alternative platform. In order to facilitate this, a
packages[*].platforms[*].deprecated field was added to the Arduino package index format (#1278) and this information is used to
enhance the user interfaces of the official Arduino development software.

This field is undocumented, meaning platform developers will be unlikely be aware of its existence.

  • What is the new behavior?

This useful feature is now documented in the Arduino package index specification.

Not breaking

…ge index field

In the event an Arduino boards platform is deprecated by the maintainer, it will be useful to clearly communicate this
fact to the user and ensure they will easily find a preferred alternative platform. In order to facilitate this, a
`packages[*].platforms[*].deprecated`field was added to the Arduino package index format and this information is used to
enhance the user interfaces of the official Arduino development software.

This useful feature is now documented in the Arduino package index specification.
@per1234 per1234 added the topic: documentation Related to documentation for the project label Oct 14, 2021
@per1234 per1234 merged commit 1bd9945 into arduino:master Oct 14, 2021
@per1234 per1234 deleted the document-platform-deprecation branch October 14, 2021 07:24
d-a-v pushed a commit to d-a-v/arduino-cli that referenced this pull request Oct 14, 2021
…ge index field (arduino#1510)

In the event an Arduino boards platform is deprecated by the maintainer, it will be useful to clearly communicate this
fact to the user and ensure they will easily find a preferred alternative platform. In order to facilitate this, a
`packages[*].platforms[*].deprecated`field was added to the Arduino package index format and this information is used to
enhance the user interfaces of the official Arduino development software.

This useful feature is now documented in the Arduino package index specification.
@per1234 per1234 self-assigned this Nov 23, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
topic: documentation Related to documentation for the project
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants